home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 028a / tia114.zip / TIA.DOC next >
Text File  |  1991-06-22  |  9KB  |  234 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.                           Truth In Advertising!
  7.                       True Date Conversion Utility
  8.                             For Archive Files
  9.                         R E V I S I O N   1 . 1 4
  10.  
  11.                          written by Bill Auclair
  12.                   Copyright (C) 1991 XanSoft Development
  13.                            All Rights Reserved
  14.  
  15.  
  16.  
  17.  
  18.  
  19.      NOTICE:
  20.  
  21.      This software is offered as Shareware. It may be freely used and
  22.      distributed, as long as all files within the package are complete
  23.      and unmodified.  If you find this program useful, a contribution
  24.      in the amount of $10 may be sent to the author at this address:
  25.  
  26.                             Bill Auclair
  27.                             XanSoft Development, Inc.
  28.                             13-1 Ridge Rd.
  29.                             Naugatuck, CT 06770
  30.  
  31.  
  32.      If this package is used within a corporate or government environment,
  33.      the contribution should be considered a requirement.  The $10 contribution
  34.      entitles the sender to complete source code, and free program updates as
  35.      they are written.
  36.  
  37.  
  38.      Files within this package:
  39.  
  40.            TIA.EXE -     The TIA True Date Conversion utility.
  41.            TIA.DOC -     The documentation file you're reading now.
  42.  
  43.  
  44.  
  45.      DISCLAIMER:
  46.  
  47.      Users of this software do so at their own risk.  The author is not
  48.      liable for damages of any kind arising from the operation, or failure
  49.      to operate, of TIA.  Damages include, but are not limited to, loss or
  50.      erasure of any files, archived or unarchived.
  51.  
  52.  
  53.  
  54.      Truth In Advertising!              - 2 -
  55.  
  56.  
  57.  
  58.  
  59.      WHAT IS TIA?
  60.  
  61.      Have you ever downloaded or file-requested a file with an interesting
  62.      name or description, only to discover after you de-archived it on your
  63.      system that it dated back to the "prehistoric" age of personal computing
  64.      (pre-1985)?  I have.  That's the main reason why I wrote this utility.
  65.  
  66.      TIA will search for ARCed, PAKed, ARJed, ZIPed & LHARCed files in a
  67.      directory, regardless of file extension. When it finds a file meeting
  68.      its search criteria, it will read the contents of the archive header,
  69.      noting file sizes and datestamps. TIA will use this information to
  70.      change the datestamp of the archive file to that of the NEWEST, OLDEST
  71.      or LARGEST file contained within. Time/datestamp selection criteria are
  72.      defined via command-line switches.
  73.  
  74.      This means that the datestamp of any archive file processed with
  75.      TIA will correspond to the creation date of one or all of the files
  76.      contained within the archive, letting downloaders and FREQers know if
  77.      they're getting a late-model program or yesterday's news.
  78.  
  79.      That's what I call "Truth In Advertising"....
  80.  
  81.  
  82.  
  83.  
  84.      WHAT TIA CAN BE USED FOR:
  85.  
  86.      TIA.EXE can be used by BBS sysops to perform a "one-shot" conversion to
  87.      "true dated" archive files.  The program can also be run from a batch
  88.      file to periodically convert any new archive files received to a
  89.      "true date" status.  TIA may defeat the purpose of certain "new files"
  90.      utilities that rely on file datestamps to indicate recent uploads to
  91.      a bulletin board system. It's best to experiment to see if this is the
  92.      case with your setup.
  93.  
  94.  
  95.      Truth In Advertising!              - 3 -
  96.  
  97.  
  98.  
  99.      USING TIA:
  100.  
  101.      TIA supports parameter-passing via the command line.  The following
  102.      are examples of valid command line syntax:
  103.  
  104.  
  105.      TIA
  106.      No parameters.  Generates a help screen.
  107.  
  108.  
  109.      TIA [<-date switch><hour min sec>]
  110.      where <-date switch> is one of the following command-line switches:
  111.  
  112.       -N   Use datestamp of NEWEST file within the original archive.
  113.       -O   Use datestamp of OLDEST file within the original archive.
  114.       -L   Use datestamp of LARGEST file within the original archive.
  115.  
  116.      where <hour min sec> is a user-specified timestamp value to be attached
  117.      to each processed archive file.  Attachment of this stamp is necessary
  118.      to avoid re-processing the same archive files each time TIA.EXE is run.
  119.      The program will examine each archive file's time stamp and will not
  120.      process the file if timestamp values match those specified on the
  121.      command line.  There is a VERY slim chance (1 in 43200) that an
  122.      unprocessed archive file will have the same time stamp as that specified
  123.      on the command line, but with those kind of odds, it's not much to worry
  124.      about.  The default time stamp is 11:28:58, which does not have to be
  125.      entered on the command line.
  126.  
  127.      NOTE:   Datestamp resolution is 2 seconds, which means that if you want
  128.              to reprocess files for any reason, you'll have to change the
  129.              datestamp value originally specified on the command line by at
  130.              least 2 seconds.
  131.  
  132.  
  133.  
  134.      Truth In Advertising!              - 4 -
  135.  
  136.  
  137.  
  138.      USING THE TIA ENVIRONMENTAL VARIABLE
  139.      
  140.      TIA can be run in auto-processing mode by using the DOS SET command to
  141.      create a pointer to the subdirectory where BBS configuration files can
  142.      be found.  TIA now supports auto-search of Opus 1.0x/1.1x, Maximus and
  143.      T.A.G. BBS configuration files, using the download directory as specified
  144.      within these files.  The TIA environmental variable may be set from the
  145.      DOS command line, or from within the AUTOEXEC.BAT file, using the
  146.      following syntax:
  147.  
  148.      
  149.                                   SET TIA=D:\Path
  150.                                   
  151.  
  152.      where D:\Path is the subdirectory in which BBS configuration files are
  153.      stored.  TIA will automatically process all subdirectories defined in
  154.      configuration files.  If the TIA variable is not found, processing will
  155.      be confined to the current subdirectory.  A trailing backslash (\) is
  156.      not required.  NOTE:  Make sure you are not within a DOS shell when 
  157.      setting the environmental variable, as it will "disappear" when you
  158.      return to the primary command processor!     
  159.      
  160.  
  161.  
  162.      SKIPPING AUTO-PROCESSING FOR CERTAIN SUBDIRECTORIES
  163.      
  164.      There may be certain subdirectories defined within your BBS configuration
  165.      files that you wish not to be processed.  To get TIA to skip these areas
  166.      during auto-processing, use the COPY command to create a file named
  167.      SKIP.TIA in each subdirectory you wish to bypass, using the syntax below:
  168.  
  169.  
  170.      
  171.                       COPY CON SKIP.TIA (press ENTER)
  172.                       (type a few random characters and press ENTER)
  173.                       (press CTRL/Z and then press ENTER)
  174.                       
  175.                       
  176.      ATTENTION BBS PROGRAM DEVELOPERS!  If you wish to include auto-processing
  177.      of your program's configuration files as a feature in TIA, please send
  178.      the necessary header structure codes to FidoNet node 1:141/545, or use
  179.      the U.S. Mail address listed at the beginning of this document.
  180.      
  181.  
  182.  
  183.      INSTALLATION STEPS:
  184.  
  185.      1. Install TIA.EXE in the DOS subdirectory of your choice. Make sure
  186.         the directory is included in your DOS path.
  187.  
  188.  
  189.  
  190.      Truth In Advertising!              - 5 -
  191.  
  192.  
  193.  
  194.      REVISION HISTORY:
  195.  
  196.      5/5/89:   Version 1.00-- first public release of TIA.
  197.  
  198.      7/1/89:   Version 1.01-- got rid of a few nasty bugs, including one
  199.                which caused TIA to generate strange date stamps on archive
  200.                files unable to be processed correctly (bad archive, etc.)
  201.                Thanks to Don Dawson of 1:141/730 for his debugging efforts.
  202.  
  203.      5/19/90:  Version 1.10-- Eliminated the need for a "work" directory--
  204.                TIA now gets file size/datestamp info directly from the
  205.                archive header, without de-archiving files.  Dropped support
  206.                for .ZOO files, due to ZOO's somewhat quirky archive header
  207.                structure. Improved archive recognition subroutine-- TIA will
  208.                now recognize archives regardless of extension.
  209.  
  210.      7/15/90:  Version 1.10a-- Fixed a nasty little bug that was causing TIA
  211.                to lock up when attempting to read the headers of .ZIP files
  212.                created with PKZIP's "verification" option.  Many thanx to
  213.                Bob Davis at 1:106/114 for reporting this one.
  214.  
  215.      3/2/91:   Version 1.12-- Added support for ARJ and LHA archives.  Fixed
  216.                a bug that was causing TIA to use compressed, rather than
  217.                original, file sizes when calculating date stamps for .ARC
  218.                and .PAK archives when the -L datestamp option was chosen.
  219.                Added support for I/O redirection.
  220.  
  221.      6/22/91:  Version 1.14-- Added auto-processing functions and support for
  222.                Opus, Maximus and T.A.G. BBS programs.  Also added capability
  223.                to skip auto-processing for certain subdirectories through use
  224.                of the SKIP.TIA flag file.  Added support for ARJ and LHA(rc)
  225.                archive utilities.
  226.                
  227.  
  228. Please send all compliments, criticism, advice and bug reports to:
  229.  
  230.                         Bill Auclair
  231.                         Xanadu BBS
  232.                         FidoNet Node 1:141/545.0
  233.  
  234.